New: Enhance API endpoint to support additional filters

Resolves #7484

Description

Enhances the Give\Donations\Endpoints\ListDonations API endpoint to support additional filters, providing the necessary hooks for compatibility with third party add-ons / snippets.

The main goal is to extend the flexibility of the Donations\ListTable in the admin interface, allowing for the integration of new filters, such as filtering donations by donor ID.

Affects

Admin List Tables

Visuals

N/A

Testing Instructions

Tests already included in PR : see tests/Unit/Donations/Endpoints/TestListDonations:testShouldAllowAddingFilters

To test the new hooks and extension points, add some JavaScript code on the front-end page (via a snippet):

document.addEventListener("DOMContentLoaded", () => {
    wp.hooks.addFilter('give-donations-list-table-filters', 'namespace', filters => {
        return [
            ...filters,
            {
                name: 'donor',
                type: 'search',
                text: 'Donor',
                ariaLabel: 'Search by Donor'
            },
        ];
    });
});

Go to the back office > Give > Donations, new filter input added for Donor ID, lastname or firstname.

To allow using filters that are not already managed by ListDonations

Pre-review Checklist

• Acceptance criteria satisfied and marked in related issue
• Relevant @unreleased tags included in DocBlocks
• Includes unit tests
• [-] Reviewed by the designer (if follows a design)
• Self Review of code and UX completed